class: center, middle, inverse, title-slide .title[ # <br><br> Introducción a Git y GitHub con R ] .author[ ### Joselyn Chávez <br> <a href="http://twitter.com/josschavezf1"> <span class="citation">@josschavezf1</span></a><br> ] .institute[ ### RLadies Bariloche ] .date[ ### 01 de junio de 2022 ] --- # ¿Qué es GitHub? - Git es un software libre que funciona como un sistema de control de versiones. - Permite guardar y compartir código. - Permite regresar a versiones anteriores, revisar cambios y crear ramas experimentales para probar código sin dañar el código principal. <img src="data:image/png;base64,#img/git.png" width="45%" style="display: block; margin: auto;" /> --- # Instalación Git se puede utilizar en todos los sistemas operativos. Algunas opciones para instalar git en tu sistema: - https://git-scm.com/book/es/v2/Inicio---Sobre-el-Control-de-Versiones-Instalaci%C3%B3n-de-Git - https://git-scm.com/downloads - https://github.com/git-guides/install-git - https://gitforwindows.org/ --- # Algunas plataformas que utilizan git .pull-left[ <br><br> <img src="data:image/png;base64,#img/GitHubLogo.png" width="80%" style="display: block; margin: auto;" /> <br><br> .center[ https://github.com/ ] ] .pull-left[<br> <img src="data:image/png;base64,#img/gitlablogo.jpg" width="72%" style="display: block; margin: auto;" /> .center[ https://gitlab.com ] ] --- # Creando mi primer repositorio de GitHub <img src="data:image/png;base64,#img/repositorio.png" width="40%" style="display: block; margin: auto;" /> --- # Conectando GitHub con RStudio .pull-left[<br> ## Paso 1: Generar un token Settings > Developer settings > Personal access tokens > Generate new token. Seleccionar: repo, write:packages y admin:org ] .pull-right[ <br><br> <img src="data:image/png;base64,#img/github.png" width="100%" style="display: block; margin: auto;" /> ] --- # Conectando GitHub con RStudio .pull-left[ ## Paso 2: Guardar las credenciales en R Copia el token del paso anterior Ejecuta el comando: ```r gitcreds::gitcreds_set() ``` Pega el token y confirma tus credenciales y los roles otorgados ```r gh::gh_whoami() ``` ] .pull-right[ <br><br> <img src="data:image/png;base64,#img/github.png" width="100%" style="display: block; margin: auto;" /> ] --- ## Clona el repositorio en tu computadora File > New Project > Version control <img src="data:image/png;base64,#img/nuevoproyecto.png" width="50%" style="display: block; margin: auto;" /> --- ## Clona el repositorio en tu computadora Selecciona la opción Git <img src="data:image/png;base64,#img/nuevoproyecto2.png" width="50%" style="display: block; margin: auto;" /> --- ## Clona el repositorio en tu computadora Pega el link del repositorio y selecciona la ubicación que tendrá <img src="data:image/png;base64,#img/nuevoproyecto3.png" width="50%" style="display: block; margin: auto;" /> --- # Creando cambios en el repositorio - Abre el archivo README.md y agrega algunas líneas. - Guarda los cambios. - Ve a la pestaña Git y selecciona la casilla del archivo. <br> <img src="data:image/png;base64,#img/gitaddd.png" width="70%" style="display: block; margin: auto;" /> --- # Subiendo cambios en el repositorio - Selecciona la opción Commit. - Escribe un mensaje de rastreo para los cambios generados. - Selecciona el botón Commit y después Push. - Verifica los cambios en el repositorio en línea. <img src="data:image/png;base64,#img/gitcommit.png" width="70%" style="display: block; margin: auto;" /> --- # Importa cambios desde el repositorio - Realiza algunos cambios en el archivo README.md desde la página de GitHub. - Importa los cambios a la computadora usando el botón Pull. <br> <img src="data:image/png;base64,#img/gitpull.png" width="70%" style="display: block; margin: auto;" /> --- # Creando colaboraciones ## Fork y Pull-request - Ve al repositorio https://github.com/josschavezf/repositorio_prueba - Selecciona el botón fork - Genera el fork en tu usuario de GitHub <img src="data:image/png;base64,#img/fork.png" width="70%" style="display: block; margin: auto;" /> --- - Clona el repositorio resultado del fork, debe lucir similar a: https://github.com/tu_usuario/repositorio_prueba - Crea un nuevo script y llámalo con tu nombre <img src="data:image/png;base64,#img/nuevo_script.png" width="30%" style="display: block; margin: auto;" /> - Guarda los cambios. - Haz un commit y push - Ve a tu repositorio en github.com dentro de tu usuario y selecciona Pull-request --- # Creando colaboraciones ## Agregando colaboradores al repositorio - Ve al primer repositorio que creaste, mi_primer_repositorio - Ve a la sección settings del repositorio <img src="data:image/png;base64,#img/settings.png" width="30%" style="display: block; margin: auto;" /> --- # Creando colaboraciones ## Agregando colaboradores al repositorio - Selecciona la sección de colaboradores en el panel izquierdo. <img src="data:image/png;base64,#img/colaboradores.png" width="30%" style="display: block; margin: auto;" /> - Selecciona Add people. - Escribe el nombre de usuario de GitHub de tu colaborador/a. - Selecciona el rol que tendrá tu colaborador/a. --- # Creando colaboraciones ## Agregando colaboradores al repositorio - Tu colaborador/a puede clonar tu repositorio directamente, sin hacer fork ni pull-request. - Pide a tu colaborador/a que clone tu repositorio en su computadora. - Tu colaborador/a generará cambios en el repositorio clonado y subirá el cambios haciendo commit y push. - Verifica que los cambios se ven reflejados en tu repositorio. --- .left-column[<br><br><br><br><br><br><br> .center[ # ¡Gracias! ] ] .right-column[<br><br><br><br> <img src="data:image/png;base64,#img/gracias.png" width="100%" style="display: block; margin: auto;" /> .pull-right[Ilustración de Allison Horst] ]